home *** CD-ROM | disk | FTP | other *** search
/ The Learning Curve / The Learning Curve (Weird Science, 1996).iso / geography / geotime / readme.first < prev    next >
Text File  |  1992-11-06  |  14KB  |  319 lines
  1.                   Geotime 1.2b - The "Ultimate" (?) Amiga clock
  2.  
  3.                        Copyright 1988,1989, 1992 by Mike Smithwick
  4.  
  5. Geotime consists of three separate programs, Geotime_m depicts a 
  6. earth map with day and nite sides shaded. You'll be able to observe the
  7. earth's shadow scroll across the map in real-time based on the system clock.
  8.  
  9. Geotime_m_wb is a workbench version of the above.
  10.  
  11. The other program, Geotime_g is a workbench clock, and shows the earth as a 
  12. globe with day and nite sides. Like the map, the shadows will progress in
  13. real-time showing the current phase of the earth.
  14.  
  15. And now a word from our sponsor:
  16.  
  17. Geotime 1.2b is freely redistributable as "shareware" (for a $20 donation) and was 
  18. developed inbetween versions of Distant Suns.
  19.  
  20. This version incorporates a number of bugs fixes that caused it to fail on ADOS 2.1.
  21.  
  22. "And we thank you for your support".
  23.  
  24. ----------------------------------------------------------------------
  25.  
  26.                                  Geotime_m
  27.  
  28. Geotime_m will display a map of the earth showing the current day and
  29. nite regions. The shadow will scroll across the map in real time.
  30. This program was inspired by "Geochron", the beautiful, illuminated large wall
  31. map that costs around $4 million bucks (actually, about 2 grand).
  32.  
  33. It is started in the traditional double-click icon method. For those who
  34. despise workbench, it may be started up from CLI by typing 
  35. "geotime_m -f coast2.sm.bin".
  36.  
  37. City and country names are read from the file "gtnames.dat". Each
  38. entry requires 3 lines in the following format :
  39.  
  40.                       name
  41.                       lat long
  42.                       time_zone
  43.  
  44. West longtitude is negative, East is positive. The time-zone is the value
  45. the must be added to your time to equal Universal Time. Most almanacs should
  46. have timezone entries for major cities.
  47.  
  48. Here's a sample entry :
  49.  
  50.                        .San Francisco
  51.                        38 -122
  52.                        7
  53.                        .Seoul
  54.                        37 127
  55.                        -9
  56.                        .London
  57.                        51 0
  58.                        -100
  59.  
  60. Time zones are floating point values since some zones are fractional hours.
  61. (The timezones in the sample file may not be correct due to the uncertainties
  62. of Daylight times around the world).
  63.  
  64. Each name will automatically be followed by a clock showing the time in
  65. 24 hour mode. Using a time-zone value of "-100" (as in the London entry)
  66. will prevent the clock from being displayed to avoid excess screen clutter.
  67.  
  68. The period before the name is used to more clearly pinpoint the location.
  69.  
  70. The star-like sprite shows the "sub-solar" point, the point on the Earth
  71. directly under the sun.
  72.  
  73. There are a couple of options you may change by use of the Workbench
  74. Icon "Tooltypes" facilities. These are used to pass startup information on to a
  75. program. Click once on the icon, then select "info" from the workbench
  76. menu. You will now see the "Info" window displaying all sorts of curious
  77. attributes about it's associated file. Near the bottom is the "TOOL TYPES"
  78. string gadget. Click on the arrows, and you see 4 different startup options.
  79. "GLOBEDATA" tells the program where to get it's map data file. For Geotime_m
  80. there are two files, "coast2.sm.bin", and "coast.wb.bin" (used for the 
  81. workbench version below), so you don't need to touch
  82. this unless you move the datafile over into another directory. Next is the
  83. "TIMEZONE" argument. This is the timezone for your location, and is determined
  84. the same way as all other timezones. The program uses this to convert the local
  85. time on your system's internal clock to Universal time. It is currently set up
  86. for Pacific time. You may also change the landmass colors using "LANDCOLOR".
  87. The following 3 numbers are the red, green and blue components. So if you wanted
  88. magenta land you would type "LANDCOLOR=15,0,15", or all red, no green, all blue.
  89. (The color values go frome 0 to 15). When done modifying the tooltypes, click
  90. on save. You may want to open the info window one more time to verify that your
  91. numbers were correctly recorded, as I ran in to some problems in this regard.
  92. NAMEDATAFILE lets you specify the name of the file to contain the location
  93. names.
  94.  
  95. Geotime_m requires the use of a special font, "flow_thin". In order to
  96. install the font, open a cli window and type "execute gt:font_install".
  97.  
  98. There are a couple of menu options that allow you to toggle on/off the
  99. clocks, names, and a clock in the menubar.
  100.  
  101. ---------------------------------------------------------------
  102.  
  103.                                 geotime_m_wb
  104.  
  105. This is a Workbench version of Geotime_m. It has several other options
  106. to let you optimize it's operations for the Workbench environment.
  107.  
  108. I elected not to support the normal sizing gadget for several reasons. So
  109. I permit sizing via both a menu option and Tooltype. There is a menu-item
  110. which will let you toggle between "small" and "large" sizes. The small
  111. size is fixed, but the large size may be specifed by the use of the
  112. Tooltype "LARGE_MAG" (for "Large Magnification"). Mulitplying the small size
  113. with this value will give you the large size. So for a map twice the
  114. small size, you would use "2.0". This SIZE Tooltype says what size the
  115. map should open. If LARGE, you will get the large size at startup, otherwise
  116. it will be small. Do not try to make the window open up larger then your
  117. workbench, it could be uncool.
  118.  
  119. TOP_EDGE and LEFT_EDGE are the pixel offsets from the edge of the screen
  120. the window will open.
  121.  
  122. SHOW_NAMES and SHOW_TIMES will turn on the names and times.
  123.  
  124. GLOBEDATA specifies the datafile to use for the map.
  125.  
  126. There are  several additional tooltypes to let you specify the
  127. color selections to use. Each of these is followed by a value which
  128. gives the color number to use. Use the workbench color option to determine
  129. how your own colors are mapped out. The color furthest to the left will be
  130. "color 0", the next is "color 1" and so on. Under 2.0 when you can have more 
  131. then 4 colors in the workbench, you may want to set colors 4 and beyond to 
  132. values which will look more like water and land. Especially since the
  133. new workbench color scheme will give a fairly dull looking display. You can
  134. add more colors by using the "colors" slider n the "screenmode" preference
  135. tool. The default colors are configured to the workbench 2.0 2-bit (4 color)
  136. configuration.
  137.  
  138. The color tooltypes are : LANDCOLOR, WATERCOLOR, SUNCOLOR, TEXTCOLOR, 
  139. LINECOLOR and SHADOWCOLOR.
  140.  
  141. As with the larger map display, the sun's "subsolar point" is marked, this time
  142. with an asterisk, whose color is set with the SUNCOLOR tooltype.
  143.  
  144. In addition to the Tooltypes, there are commandline options which may be
  145. used should you want to start the program from your startup-sequence.
  146.  
  147.    -f <file>   : lets you pass the name of the data file to use. 
  148.    -nf <file>  : namefile, the file to use for the location names
  149.    -tz <value> : value is the timezone
  150.    -land <col> : land color
  151.    -water <col>: water color
  152.    -sun <col>  : sun color
  153.    -text <col> : text color
  154.    -line <col> : line color
  155.    -shadow <col>      : shadow color
  156.    -names      : display the names
  157.    -times      : display the times
  158.    -leftedge <value>  : distance from the lefthand edge in pixels
  159.    -topedge  <value>  : distance from the top edge in pixels
  160.    -large      : open up map using the large size
  161.    -mag        : magnification value based on the small size, must be before
  162.                  the -large option
  163.  
  164.  
  165. So if you wanted to start the map up using the large size, 2.2 times the
  166. size of the smaller version, 20 pixels from the left, 12 from the top, in
  167. the Pacific time area you would type :
  168.  
  169.    geotime_m_wb -f coast.wb.bin -leftedge 20 -topedge 12 -mag 2.2 -large
  170.  
  171. If you are running with limited memory, you may want to use the smaller
  172. "coast.wb.bin" database, which is about half the size for the full screen
  173. map, geotime_m. This contains only half of the data points of the large giving
  174. less resolution. Under most cases this will not be noticible.
  175.  
  176. Note that the smaller size of the Workbench map means that you probably
  177. can't use the same name file you would for geotime_m. So you will likely
  178. want to use a different version with fewer names.
  179.  
  180. Geotime_m_wb will update the shadow once every 5 minutes, and will work
  181. in both interlaced and non-interlaced screens.
  182.  
  183. ---------------------------------------------------------------
  184.  
  185.                                  geotime_g
  186.  
  187.  
  188. Geotime_g will depict the earth as if you will an astronaut orbiting about
  189. 300 zillion miles up. The earth's shadow will be correct for the date and
  190. time, and will advance as time itself advances.
  191.  
  192. Start this up via the icon, CLI or startup-sequence as mentioned above.
  193.  
  194. At startup you are in "orbit" mode, in which the viewpoint in effect 
  195. "orbits" around the planet. (otherwise it would be a really boring display.)
  196.  
  197. Geotime will work in both interlace and non-interlaced modes. Although
  198. it looks the niftiest in Hi-res interlace with dropshadow.
  199.  
  200. As with Geotime_m_wb, there are several Tooltype required. The only different
  201. one is "PRIORITY" which lets you set the priority of the task. The value
  202. must be between -128 to +128. Higher priorities will give you faster updates
  203. however. The default is -100. By setting a priority of -20 you can about 
  204. double the speed of the updates.
  205.  
  206. The LARGE and LARGE_MAG options work as above as well as the sizing
  207. menu-item. Due to the complex structure of the coastlines, the small
  208. size of the globe on a non-interlaced screen will not work correctly.
  209. (Plus it just doesn't look all that hot).
  210.  
  211. As above, Geotime_g has several color setting options : WATERCOLOR, LANDCOLOR,
  212. TEXTCOLOR, SHADOWCOLOR, LINECOLOR and SPACECOLOR. The SPACECOLOR is specific
  213. to this program and specifies what color the regions around the globe should be.
  214. And as above, these may all be specified via the same command line arguments,
  215. with the addtion of -space.
  216.  
  217. Notice that the globe and map use different format files so don't try to
  218. interchange the two.
  219.  
  220. Geotime_g has the same command-line options as above, with the extra
  221. "-pri" choicee to set the priority.
  222.  
  223. If the globe is not circular, your monitor may need some adjustment.
  224. It may take an update or two for any changes in the settings window
  225. to take affect.
  226.  
  227. Geotime_g has several menu options. . .
  228.  
  229.                              System menu
  230.  
  231. In the systems menu, "settings" will allow you to set some basic
  232. information needed. Timezone is the number of hours which you need to 
  233. add to your local time to arrive at Universal Coordinated Time (the old 
  234. "GMT"). +7 is good for the SF Bay Area.
  235.  
  236. View lat : sets the viewer latitude. Defaults to 0 degrees. (dd.mm format)
  237.      Setting this positive will put you above the equator when looking
  238.      at the globe.
  239.  
  240. View long : sets the viewer longtitude. Defaults to 0 degrees. This advances
  241.      5 degrees each update while in orbit mode.
  242.  
  243. Lat : user's latitude. Put your home's latitude here for the "location"
  244.      highlight option. 
  245.  
  246. Long : user's latitude. Put your home's longtitude here.
  247.  
  248. Save : This will save all of your settings to a file, "geotime.dat".
  249.  
  250. If you make a mistake, the screen will flash a bunch of times and you won't
  251. be able to leave the requestor.
  252.  
  253. The latitudes go from -90 to +90 degrees. Longtitudes go from 180 W to 0 to
  254. 180 E. So for instance, the longtitude for San Francisco, 122:27 degrees 
  255. West, would be entered as "122.27 W".
  256.  
  257.                           Neat Stuff menu
  258.  
  259. Highlights : "Continents" will put an outline on the land masses. 
  260.      "Location" will put a "*" at whatever location you specify in 
  261.      the settings window.
  262.  
  263. Indicators : "Clock" will display the current date and time, while
  264.      "legend" shows how the sunny side is colored vs. the shaded side.
  265.  
  266. Mode : This lets you toggle between the orbit/hover rotational modes. 
  267.      "Orbit", the default, presents the planet to you as if you were
  268.      orbiting around in a very fast spacecraft from West to East. "Hover" 
  269.      puts you above a fixed point specified by the view lat/view long 
  270.      entries in the settings window. Hover is a really dull mode.
  271.  
  272. Shadow : "Shaded", the default, gives you a shadow tint, while "black" will
  273.      completely blacken the shadow to more closely mimic the view from 
  274.      space.
  275.  
  276. Size : "Large" will expand the window to a size X times larger then 
  277.      the fixed "small" size (note that the small size will not work
  278.      right on a non-interlaced screen).
  279.  
  280. ---------------------------------------------------------------------
  281.  
  282.                                      Misc
  283.  
  284. The data used contains about 3000 points culled from a 6000 point
  285. database. (I may release the larger one sometime, it doesn't look that much
  286. better on the globe, but it is quite nice on the map).
  287.  
  288.  
  289. ---------------------------------------------------------------------
  290. (Warning! Warning! The following is an unabashed commercial announcement!)
  291.  
  292. If you do enjoy this program, you may want to take a look at something else
  293. I've done. It's called Distant Suns , 
  294. and is an astronomy simulation. It will display up to 255,000 stars along with 
  295. planets, asteroids and comets. 
  296.  
  297. Distant Suns has won an award in the May, 1988 Consumer Electronics Show 
  298. for the most innovative Educational Program of the Year as well as The 1991 Commodore Developer's Choice award.
  299.  
  300. A recent review in Sky and Telescope magazine called Distant Suns "powerful and
  301. visually stunning", and many users write in to me saying things like
  302. "at last, a program that justifies my Amiga", or "Wonderful!".
  303.  
  304. Distant Suns is not meant just for folks with a telescope, but for anyone who
  305. has ever wondered about what's up in the night sky. (As a matter of fact,
  306. only a handful of owners stated they had a telescope. But those who do
  307. love the program).
  308.  
  309. So, when you're tired of exploring fictional universes, give the real
  310. one a shot, I think you'll enjoy it. 
  311.  
  312.              (End of the unabashed commercial announcement!)
  313.  
  314. ***********************************************************************
  315.  
  316. Send comments to : Mike Smithwick, 25215 La Loma Drive,
  317. Los Altos Hills, CA  94022
  318.  
  319.